home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / comm / bbs / RIPGRF52.lha / RIPGRAF.DOC < prev    next >
Text File  |  1993-09-18  |  13KB  |  310 lines
  1.                                 RIPGRAF 0.52
  2.  
  3.                       Copyright (C)1993 Michael Nelson
  4.                             All rights reserved.
  5.  
  6.  
  7. INSTALLATION
  8. ~~~~~~~~~~~~
  9.  
  10. Please install the included font (called RIPstandard.font) to your FONTS
  11. directory. It is not really necessary, as the program will use the topaz
  12. font if it cannot find the RIPstandard font.
  13.  
  14. To start the program, Click on the RIPGRAF icon or type RIPGRAF in a CLI.
  15.  
  16.  
  17. NOTE: THIS PROGRAM REQUIRES WB 2.04+ AND WILL NOT WORK ON ANYTHING LESS!
  18.  
  19.  
  20. How to use the program
  21. ~~~~~~~~~~~~~~~~~~~~~~
  22.  
  23. Toolbar:
  24.  
  25. The heart of the program is the toolbar, so I will attempt to explain it,
  26. in point form, gadget by gadget from left to right:
  27.  
  28.     CLR  -     Clear the screen completely, all your work is erased.
  29.  
  30.     UNDO -     Available in the REGISTERED version only. This will UNDO
  31.         the last object added to the editing area, and continue
  32.         erasing objects until you are back to a blank screen.
  33.  
  34.     DOTS -  Pixel drawing. Click the mouse button (either one) and
  35.         a pixel will be drawn using the current drawing Color.
  36.  
  37.     LINES-  This has been changed since the last release, the arrow
  38.         pointing down indicates that there is a "sub-toolbar"
  39.         for this gadget. Click on it to display the line options.
  40.  
  41.         BACK -    Moves from the line options tools back to the
  42.             main toolbar. When you do this the Line-arrow
  43.             will still be highlighed and whatever line option
  44.             you chose will still be active
  45.  
  46.         LINE -    Normal lines. Click either button to start the
  47.             line and release. Move rubber-band line to the
  48.             ending position and click either button. The line
  49.             will then be drawn in the current drawing color,
  50.             thickness and (not yet)pattern.
  51.  
  52.         CONTINUOUS - Connected lines. Click either button to start
  53.             the line and release. Move the rubber-band line to
  54.             the end of *THAT* segment and click the LEFT mouse
  55.             button to draw that segment in the current drawing
  56.             color, thickness and (not yet) pattern. The next
  57.             segment will now be started... and so on until you
  58.             draw as many connected lines as needed. Click the
  59.             RIGHT mouse button to stop drawing connected lines.
  60.  
  61.         RAYS -    Rays are lines which share a common starting point.
  62.             Click either button to start. This determines the
  63.             "center" or starting point that all lines will share.
  64.             Move the rubber-band to where you want it placed and
  65.             click the left mouse button, now you have a second
  66.             rubber-band line being drawn from the previous line's
  67.             starting point. When you no longer want to draw rays
  68.             click the RIGHT mouse button to finish the last ray.
  69.  
  70.         BEZIER- Bezier curves are composed of two "anchor" and two
  71.             "hug" handles. To draw a curve, first click either
  72.             button to start a rubber-band line (the first anchor
  73.             point), and move to the end (the second anchor point)
  74.             and click the left mouse button. Now the initial
  75.             bezier curve will be drawn, along with the four
  76.             positioning "handles" (displayed as x's). To grab
  77.             a handle click near it (and release the button), now
  78.             move the handle and the curve will be changed. Click
  79.             the LEFT mouse button to drop the handle. Continue
  80.             picking up/dropping handles until the curve looks
  81.             like you want. Click the RIGHT mouse button to draw
  82.             the finished curve using the current drawing color,
  83.             thickness(not yet) and pattern(not yet).
  84.  
  85.     SQUARES- This gadget selects the square (rectangles really) function
  86.         Depending on which part of the gadget you click in, you will
  87.         either get unfilled or filled squares. The gadget imagery
  88.         will change to reflect which type you selected. Click either
  89.         button to start a square and release the button. Move the
  90.         rubber-band square and click either button to draw the
  91.         finished square using the current drawing color, thickness
  92.         and (not yet) pattern for UNFILLED, and the current FILLING
  93.         color and FILL pattern for FILLED squares.
  94.  
  95.     CIRCLES-This has been changed since the last release, the arrow
  96.         pointing down indicates that there is a "sub-toolbar"
  97.         for this gadget. Click on it to display the circle options.
  98.  
  99.         BACK -    Moves from the circle option tools back to the
  100.             main toolbar. When you do this the circle-arrow
  101.             will still be highlighed and whatever circle option
  102.             you chose will still be active
  103.  
  104.         UNFILLED CIRCLE - Click either button to start, move the
  105.             rubber-band circle until you have the size you
  106.             want and click either mouse button to draw the
  107.             finished circle using the current drawing color,
  108.             thickness.
  109.  
  110.         FILLED CIRCLE - Click either button to start, move the
  111.             rubber-band circle until you have the size you
  112.             want and click either mouse button to draw the
  113.             finished circle using the current drawing color,
  114.             thickness, with the interior filled using the
  115.             current filling color and fill pattern.
  116.  
  117.                 UNFILLED OVAL - Indentical in usage to UNFILLED CIRCLE,
  118.                     except you can draw ovals.
  119.  
  120.                 FILLED OVAL - Indentical in usage to FILLED CIRCLE, except
  121.                     you can draw ovals.
  122.  
  123.                 CIRCLE ARCS - Not supported in this release.
  124.  
  125.                 OVAL ARCS - Not supported in this release.
  126.  
  127.                 CIRCLE PIE SLICE - Not supported in this release.
  128.  
  129.                 OVAL PIE SLICE - Not supported in this release.
  130.  
  131.                 NOTE: The circle drawing routines *HAVE* been changed from
  132.                       previous releases. This allows me to add support for
  133.                       ARCS and PIES, as well the routine draws a little
  134.                       faster than the graphics library routines.
  135.  
  136.     POLYGONS- This gadget selects the polygon function. Depending on
  137.         which part of the gadget you click in, you will either get
  138.         unfilled or filled polygons. The gadget imagery will change
  139.         to reflect which type you selected. Click either button to
  140.         start drawing a polygon, and move the rubber-band line to
  141.         place the first segment of the polygon, and click to draw
  142.         that segment in the current color, thickness and (not yet)
  143.         pattern. A new rubber-band line will be started at the end
  144.         of the last segment, place it like you did the first and
  145.         continue. To end the polygon click the RIGHT mouse button,
  146.         and the polygon will be AUTOMATICALLY closed.
  147.  
  148.     TEXT -    Clicking on the Text gadget (the big A), will put you in
  149.         the text "adding" mode. To enter/place text, click somewhere
  150.         on the drawing area (it makes NO difference where, this
  151.         is done to tell the program you want to enter some text)
  152.         A text requester will now open. Enter the text in the string
  153.         gadget and hit return. Change the Font cycle gadget to the
  154.         font you wish to use and adjust the Font size slider to the
  155.         size you want. Click the Window Close gadget, and you will
  156.         now place the text string. The STANDARD font is an Amiga
  157.         bitmapped font and displays in real time as you place it,
  158.         all other 10 fonts are scalable fonts and use a placment
  159.         box. The scalable placement box has one line through the
  160.         middle (horizontally), this is the text baseline and the
  161.         space below it is where the descenders are drawn (like in
  162.         p and q). Click either button to finish the text placement,
  163.         and draw it using the current drawing color.
  164.  
  165.         NOTE: The 10 scalable fonts were all designed at a font
  166.         size of 4, so this is the size they look best in. Some
  167.         fonts (like Small) are virtually unreadable at size 1.
  168.  
  169.         The UNREGISTERED version only supports ONE scalable font,
  170.         so no matter which font you have the cycle gadget set to,
  171.         you will only get that one font. To see what your missing
  172.         out on view the "Fonts.pic" IFF file. (REGISTER and you can
  173.         use all those nice looking fonts)
  174.  
  175.     FLOOD-    Flood filling. Click either button at the point you want to
  176.         begin the fill, and the filling will use the current fill
  177.         color and pattern, with the boundary color set to the
  178.         current drawing color.
  179.  
  180.     ICON-    Icon placing. Depending on whether you had previously
  181.         loaded an icon, you will see a icon "box" showing the
  182.         exact size and location where the loaded icon would be
  183.         drawn. If you have no icon loaded, you will see nothing
  184.         (not even the pixel cursor). To load an icon you can
  185.         either click the right mouse button to access the ASL
  186.         file requester or double click on the icon gadget.
  187.  
  188.         While you have an icon loaded (and the icon placement
  189.         box will be displayed) click the left mouse button
  190.         to draw the image of the loaded icon.
  191.  
  192.         NOTE: If you REGISTER you will receive a program which
  193.         will convert an IFF file into an ICON (ICN file). I
  194.         did the BOING.ICN (included) using DeluxePaint and then
  195.         converted it to an ICON (the original IFF brush is
  196.         included as well).
  197.  
  198.  
  199.     BUTTON-    Not functional yet. Soon (the next release) I will be
  200.         supporting mouse fields, which just define an area in
  201.         which a mouse click would "do" something. Button support
  202.         will come later. Buttons have special effects and imagery
  203.         you can use like a Mouse field (or just for non-usable
  204.         imagery)
  205.  
  206.     LINE STYLE- This area of the toolbar selects the current line
  207.         thickness and pattern for line routines which support
  208.         them.
  209.  
  210.         NOTE: The line pattern gadget (below the two thickness
  211.         gadgets) is not yet functional.
  212.  
  213.     PATTERN - This area has the FILL pattern gadget in it. Click on
  214.         the gadget to cycle through all the possible patterns.
  215.  
  216.         NOTE: Custom defined fills are possible with RIP, and I
  217.         will be adding a FILL editing requester to the program.
  218.  
  219.     DRAW/FILL COLORS- This area has the palette, as well of the two
  220.         color gadgets, which determine whether the draw or fill
  221.         is changed to the color you select from the palette.
  222.  
  223.         NOTE: RIP uses 16 colors out of a usable palette of 64
  224.         colors. RIPGRAF "knows" how to calculate those colors,
  225.         and if you using the REGISTERED version, it will change
  226.         the colors accordingly. A future version will add a color
  227.         requester to allow you to select which of the 64 colors
  228.         you wish to use. As well I will add support for reading/
  229.         matching an IFF palette to the 64 color RIP palette. (for
  230.         using the IFF2ICN program)
  231.  
  232. Menu:
  233.     The menu currently only has a "project" menu, but I hope to
  234.     add other stuff later. The menu options are straight forward,
  235.     and pretty much do what they say. ;-)
  236.  
  237.  
  238. LEGAL STUFF
  239. ~~~~~~~~~~~
  240.        THERE IS NO WARRANTY FOR THIS PROGRAM, TO THE EXTENT PERMITTED BY
  241. APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  242. HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  243. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
  244. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  245. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
  246. YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
  247. NECESSARY SERVICING, REPAIR OR CORRECTION.
  248.  
  249.        IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  250. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  251. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  252. GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE
  253. OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA
  254. OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  255. PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
  256. EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
  257. SUCH DAMAGES.
  258.  
  259. DISTRIBUTION
  260. ~~~~~~~~~~~~
  261.    This unregistered version of RIPGRAF may be freely distributed. However
  262. it may not be included with any commercial program package without my prior
  263. consent. Fred Fish (and other shareware venders) may distribute this
  264. archive in any format they desire, provided they charge for the media and
  265. compilation and not for the RIPGRAF program itself, making that fact plainly
  266. clear to people using/purchasing the program compilations, that they have no
  267. right to any registered version of RIPGRAF unless they have registered the
  268. program with the author (Michael Nelson).
  269.  
  270.  
  271. SUPPORT
  272. ~~~~~~~
  273.  
  274. I can be reached by Internet as M.NELSON34@GENIE.GEIS.COM and in October '93
  275. I will have a support BBS, where you will be able to download updates of the
  276. program as well as other RIPish stuff, running 24hrs/day on (519)542-6788
  277. (V.32/V.42bis supported). On FIDOnet my address is Mike Nelson (1:246/44.2)
  278.  
  279.  
  280.  
  281. REGISTERING
  282. ~~~~~~~~~~~
  283.  
  284. If you'd like to register RIPGRAF, then send a registration fee of
  285. $23 US ($23 CAN for Canadian residents) to:
  286.  
  287.                                 Mike Nelson
  288.                              76 Olympus Ct. #59
  289.                               Sarnia, Ontario
  290.                               CANADA  N7S 4S7
  291.  
  292. Print out the registration form (or otherwise provide me with the
  293. same info) and include it with your registartion.
  294.  
  295. Registered users will receive, by mail, a version of RIPGRAF which allows
  296. the loading of RIPscrip files, uses all ten scalable fonts, has unlimited
  297. UNDO enabled, and comes with a program to convert IFF image files into the
  298. RIP icon (ICN) format.
  299.  
  300.  
  301. QUOTE (not very topical, but I like it)
  302. ~~~~~
  303. "I took the liberty of examining that parrot, and I discovered that the
  304. only reason that it had been sitting on it's perch in the first place
  305. was that it had been nailed there."
  306.  
  307.                     - John Cleese
  308.                       "Dead Parrot" Sketch
  309.  
  310.